home *** CD-ROM | disk | FTP | other *** search
/ Disc to the Future 2 / Disc to the Future Part II Programmer's Reference (Wayzata Technology)(6013)(1992).bin / MAC / THINKC / 4_0 / GNUUCP_2 / SOURCE / VMS.REA < prev   
Text File  |  1989-07-31  |  4KB  |  115 lines
  1. NOTES.
  2. ===== 
  3.  
  4. This is UUSLAVE for VMS, part of John Gilmore's UUSLAVE. The
  5. program is intended to make a VAX/VMS node look like a Unix UUCP site.
  6. Programs are provided that allow incoming UUCP mail to be spooled and
  7. then delivered on the VAX automatically via regular VAX mail.
  8.  
  9. Outgoing mail from the VAX is posted via a separate program called
  10. rmail.  UUSLAVE also now allows a VAX/VMS node to be a forwarding site
  11. for UUCP mail.
  12.  
  13. The program was developed under VAX/VMS V4.4 on a microvax using VAX-C
  14. 2.2.  Due to differences in record formats between VMS and UNIX, it's
  15. really most useful at this time for transferring ascii text (e.g.
  16. mail) between systems.
  17.  
  18. INSTALLATION.
  19. =============
  20.  
  21. 1). Create a regular user account on the VAX called (for example)
  22. UUCP.  Arrange that logging in to this account runs the VMS command
  23. file GNUUCP.COM. This command file invokes GNUUCP and subsequently,
  24. UUXQT.
  25.  
  26. 2). Define CONTROL in includes.h. This should be a full filespec for
  27. the ascii file GNUUCP.CTL that contains all the other site specific
  28. information that GNUUCP needs. Also define EXEDIR as the directory
  29. where rmail will live once you have built it.
  30.  
  31. I usually make 3 directories (one for source user2:[uucp.gnuucp], a
  32. spool directory user2:[uucp.spool] and a public directory
  33. user2:[uucp.uucppublic]). It may pay you to do the same. my EXEDIR is
  34. the source directory, and that's also where I keep GNUUCP.CTL.
  35.  
  36. 3). Make sure that the file specifications in GNUUCP.COM agree with
  37. where you've put the actual executables.
  38.  
  39. 4). Next, create the CONTROL file itself. See GNUUCP.CTL for an
  40. example of what the file should look like e.g.  this:
  41.  
  42. nodename    hoptoad
  43. debug        -1
  44. spool        user2:[uucp.spool]
  45. logfile        user2:[uucp.spool]LOGFILE
  46. pubdir        user2:[uucp.uucppublic]
  47. sysfile        user2:[uucp.source]l.sys
  48. userfile    user2:[uucp.source]userfile
  49.  
  50. port        ACU hayes tta2: 1200
  51. port        ACU hayes tta2: 2400
  52. port        ACU hayes tta2: 300
  53.  
  54. port        ACU hayes tta3: 1200
  55. port        ACU hayes tta3: 2400
  56. port        ACU hayes tta3: 300
  57.  
  58. The Debug line is optional and gives the debugging level. The higher
  59. the number, the more debugging information. I always use 9 for
  60. debugging.  Spool gives the file spec of the mail spool directory.
  61. Sysfile gives the location of the L.sys file.  nodename is the uucp
  62. name of the VAX/VMS node (make up your own).  userfile is the location
  63. of the USERFILE (empty for now).  pubdir is the location of the PUBLIC
  64. directory.  Files transferred by uucp commands end up here.
  65.  
  66. 5). The l.sys file should contain the name of each uucp site you which
  67. uuslave to communcate directly with, each site name on a line by
  68. itself. Later, when dialout is operational, additional information
  69. will be needed for each site.
  70.  
  71. 6). Compile everything by running VMS.COM. It compiles perfectly over here, so
  72. if you have problems, contact me.
  73.  
  74. OVERVIEW OF OPERATION.
  75. ======================
  76.  
  77. When a remote system logs in to VAX/VMS to the UUCP account set up in
  78. step one, GNUUCP.COM is run. This starts up GNUUCP, which copies mail
  79. between Spool and the remote system.  Once GNUUCP terminates, UUXQT is
  80. invoked by GNUUCP.COM.  UUXQT invokes RMAIL to deliver all incoming
  81. mail.  RMAIL in turn invokes the VAX/VMS mailer to deliver the mail.
  82.  
  83. For outgoing mail, RMAIL itself queues up files in Spool, which
  84. UUSLAVE transfers to remote systems when polled.
  85.  
  86. NOTES
  87. =====
  88. setuid is not readily available under VMS, so instead, everyone must have
  89. read/write permission to the spool area, and must have sufficient disk
  90. quota there to be able to create spool files. Totally insecure,  but very easy
  91. to implement.
  92.  
  93. The BSD call "system" as implemented for VMS may hang due to
  94. insufficient resources (brilliant implementation by DEC there). If you
  95. suspect this, Check by invoking rmail with a -x9 flag. Look for a line
  96. which indicates that mail has been invoked using the "system" call,
  97. and, more importantly, that "system" subsequently returns e.g.
  98.  
  99. rmail -x9 user
  100. some text....
  101. CTRL-Z
  102.  
  103.  
  104. calling system: MAIL D.tmpA0004 user
  105. spawn: completed 1 
  106. system returned status = 0 
  107.  
  108. You must have sufficient system resources to spawn subprocesses and to
  109. keep enough files open when this happens. Consult your VMS manual for
  110. more details, since it's impossible to account for all the versions
  111. here.
  112.  
  113. N.B.  Any incoming file name with a "/" in it is copied to PUBDIR,
  114. otherwise to SPOOLDIR.
  115.